home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / fsnip101.arc / FILESNIP.DOC < prev    next >
Encoding:
Text File  |  1990-06-09  |  7.1 KB  |  178 lines
  1. File-SNIP 1.0  The Downloader's friend.
  2. By Mad Monk Software
  3.  
  4.  
  5. Legal Notice:
  6. =============
  7.  
  8. Mad Monk Software is not responsible for any damages caused by the use
  9. of or inability to use this program.  
  10.  
  11. SourceWare Notice:
  12. ==================
  13.  
  14. File-SNIP is SourceWare, which means that you are free to try the
  15. program to make sure it works for you before you register it, and you
  16. get source code to better understand how the program works and/or
  17. modify it to properly suit your needs.  This doesn't mean that you can 
  18. try it for ever, as trying it in this case means that you use it ten 
  19. (10) times or less.  If you find yourself utilizing this program more 
  20. than 10 times, you are required to register your copy.
  21.  
  22.  
  23. Registration:
  24. =============
  25.  
  26. Registration is simple.  Print out the registration form which came in
  27. this original .ZIP packet (FILESNIP.REG).  Then fill in the blanks,
  28. enclose whatever you feel the program is worth, and send it to: 
  29.  
  30. Mad Monk 
  31. Software Division
  32. P.O. Box 90303
  33. San Diego, CA  92109.
  34.  
  35.  
  36. Program Background:
  37. ===================
  38.  
  39. File-SNIP came about because of my desire to be able to download files
  40. off of BBSs and keep track of what each file does by copying the 
  41. description given on the BBS into a file that is then zipped into the
  42. file that I download.  As a sysop I utilize a program called SDI (Smart
  43. Directory Integrator (C) 1989 by Robert B. Browne and Smart Office
  44. Solutions.)  which extracts a file called DESC.SDI from a zip packet 
  45. and inserts the text it into a BBS file directory then moves the file 
  46. to the uploaded files directory.  This means that sysops can receive 
  47. files over a network or from other BBSs and incorporate them into
  48. their own system without haveing to do a large amount of work to add
  49. descriptions, move files, etc.  File-SNIP will help sysops because
  50. after the sysop has downloaded files from other BBSs, s/he can copy
  51. the FILENAME.RTT file that is created by File-SNIP (Where FILENAME is
  52. the name of the zipfile) to DESC.SDI and zip it into the packet.  This
  53. is especially easy if the sysop has an editor with macro capabilities,
  54. as s/he can create a batch file to do all of the files at the same
  55. time.
  56.  
  57.  
  58. Compatability:
  59. ==============
  60.  
  61. File-SNIP was meant to be used with Qmodem 4.x and PCBoard/ProDoor.
  62. It may work with other communications and BBS programs as well.
  63.  
  64.  
  65. Starting and Using the Program:
  66. ===============================
  67.  
  68. To start the program with .RTT files being placed in current directory
  69. just type "FILESNIP".  Otherwise start the program as follows:  
  70. FILESNIP ROWS,COLS,/P=PATH  (ie.  filesnip 25,80,/P=d:\down)
  71.  
  72. It is recommended that you utilize the MARK.COM and RELEASE.COM
  73. programs from TurboPower Software with File-SNIP to allow you to
  74. remove it from memory when you don't need it.
  75.  
  76. A sample batch file of how to properly load File-SNIP and your
  77. communications program would be as follows:
  78.  
  79.      @ECHO OFF
  80.      MARK
  81.      FILESNIP 25,80,/P=D:\DOWNLOAD
  82.      CD \QMODEM
  83.      QMODEM
  84.      RELEASE
  85.  
  86.  
  87. Once in your communications program, call a PCBoard/ProDoor BBS.  Look
  88. at a file directory.  When you see a file that you want to download,
  89. hit CTRL-~.  A block cursor will appear in the upper left hand corner
  90. of the screen if you haven't used the program previously durring the
  91. session.  You can then move the cursor to the beginning of the file
  92. description by using the arrow keys.  Hitting the INS key will move
  93. you automatically to the 34th column which is the default location for
  94. the beginning of file descriptions on PCBoard/ProDoor BBSs.  
  95.  
  96. When you have reached the beginning of the file description, hit
  97. ENTER.  Then move the cursor to the end of the description, again
  98. using the arrow keys, the END key or the HOME key.  As you move the
  99. cursor, the text between where you started and the new cursor
  100. possition will become highlighted.  When you have highlighted all the
  101. text you want to capture, hit ENTER again.  Then in the top left hand
  102. corner you will get a little menu asking you whether you want to send
  103. the description to a file, the printer, or ESCape to quit.  Normally
  104. you will want to send the text to a file, so choose F.  The menu will
  105. then be replaced with a prompt asking your for the filename to put the
  106. text in.  As long as the beginning point of your highlighted text is
  107. on the same line as the FILENAME.EXT File-SNIP will automatically
  108. prompt you to put it in FILENAME.RTT.  If you wish to use that
  109. filename, just hit return.  File-SNIP will then unhighlight the text
  110. and write it to the specified file.  Then, File-SNIP will spit out 
  111. FL FILENAME.EXT so that the file will be flagged for downloading.
  112.  
  113. If after hitting the F to send the description to a file, you decide
  114. that you don't want to flag the file and capture the text, just hit
  115. ESC.  The FILENAME.RTT will disappear, leaving you at the beginning of
  116. the filename prompt entry point.  Just hit return, without a filename,
  117. and you will be returned to perform other functions on the BBS without
  118. File-SNIP doing anything.
  119.  
  120. An example of how to use File-SNIP:
  121.  
  122. (1) hit CTRL-~
  123.  
  124. SKS-STRP.ZIP     3416  01-18-90  How to field strip and reassemble a Soviet   
  125.                                | SKS or CHinese 56 semi-automatic rifle
  126.                                | Uploaded by: Skosch
  127.  
  128. (2) move Hit INS key to move to 34th column.
  129. [(3) Move the cursor up or down to the line where the file description you 
  130. want to download begins.] 
  131.                                  
  132. SKS-STRP.ZIP     3416  01-18-90  How to field strip and reassemble a Soviet   
  133.                                | SKS or CHinese 56 semi-automatic rifle
  134.                                | Uploaded by: Skosch
  135. (4) Hit ENTER
  136. (5) Move the cursor to the end of the description by hitting the 
  137. arrow keys, the HOME key and/or the END key.  (You don't really need to 
  138. get the part about who the file was uploaded by, or any other information 
  139. that you don't need, unless you want it.)
  140.  
  141. SKS-STRP.ZIP     3416  01-18-90  How to field strip and reassemble a Soviet   
  142.                                | SKS or CHinese 56 semi-automatic rifle  
  143.                                | Uploaded by: Skosch
  144. (6) Hit ENTER
  145. (7) Hit "F" to send to file.
  146.  
  147. Filename: SKS-STRP.RTT 
  148.  
  149. (8) Hit ENTER or enter a new filename, or ESC then ENTER to cancel
  150. operation.  If you hit ENTER, File-SNIP will flag the filename for you
  151. as follows.
  152.  
  153.  
  154. SKS-STRP.ZIP     3416  01-18-90  How to field strip and reassemble a Soviet   
  155.                                | SKS or CHinese 56 semi-automatic rifle
  156.                                | Uploaded by: Skosch
  157. More?  (Y)es, (N)o, (F)lag, (NS) Non-Stop? FL SKS-STRP.ZIP
  158.  
  159.  
  160.  
  161. WARNINGS:
  162. =========
  163.  
  164. ▐   Do not use File-SNIP while in a scroll back mode
  165. ▐   In Qmodem, make sure that INT16 is not enabled in ATL-N/O/R/I
  166. ▐   Send in your registration form as soon as possible.
  167.  
  168.  
  169.  
  170. Programming Information:
  171. ========================
  172.  
  173. File-SNIP has been written in Assembly and compiled with by the Turbo
  174. Assembler version 1.0 from Borland International.  It should work on
  175. most if not all IBM type computers.
  176.  
  177.  
  178.